Delete the call details of a specific call

This endpoint marks the call detail record of one call for deletion. Until it is removed, the record is excluded from Get call details of all calls unless you ask for it with showDeleted.

Endpoint

DELETE /api/v1/calls/{callId}

Path parameters

Parameter Type Description
callId string UUID of the call.

Request

DELETE /api/v1/calls/4dd65b10-b7ab-46bb-b00d-eef6f732eff6 HTTP/1.1
Host: livehub.audiocodes.io
Authorization: Bearer {token}

Response

200 OK — the call detail fields, preceded by an expireTime giving when the record is due to be removed.

[
  {
    "expireTime": "2022-08-28T15:05:54Z"
  },
  {
    "callId": "82c6d362-d68b-4c6f-8136-1739323379e7",
    "callingEntity": {
      "id": "cc617142-e64c-474e-8023-3821472aebc0",
      "type": "sip-connection",
      "displayName": "my-sip-connection",
      "phoneNumber": "",
      "isTeams": false,
      "isClickToCall": false,
      "customizedInfo": "incoming%20test%20info%20%3C%20%3E%20%3D"
    },
    "calledEntity": {
      "id": "4e1f16c0-e132-42bb-8cdd-44de413304b9",
      "type": "bot",
      "displayName": "my-bot",
      "phoneNumber": "+15555550100",
      "isTeams": false,
      "customizedInfo": "outgoing%20test%20info%20%3C%20%3E%20%3D"
    },
    "ingressCallingNumber": "+15555550101",
    "egressCalledNumber": "+15555550102",
    "setupTime": "2022-07-01T15:17:58.223Z",
    "connectTime": "2022-07-01T15:18:00.945Z",
    "endTime": "2022-07-01T15:21:04.142Z",
    "successful": true,
    "durationSeconds": 183,
    "terminationDescription": "Terminated successfully",
    "recorded": false,
    "botConversationId": "d0a8ebf7-6015-4465-a79d-095d4f797ca3",
    "globalSessionId": "c45608120b22d073"
  }
]